<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
 <head>
  <meta http-equiv="content-type" content="text/html; charset=UTF-8">
  <title>纤程</title>
<link media="all" rel="stylesheet" type="text/css" href="styles/03e73060321a0a848018724a6c83de7f-theme-base.css" />
<link media="all" rel="stylesheet" type="text/css" href="styles/03e73060321a0a848018724a6c83de7f-theme-medium.css" />

 </head>
 <body class="docs"><div class="navbar navbar-fixed-top">
  <div class="navbar-inner clearfix">
    <ul class="nav" style="width: 100%">
      <li style="float: left;"><a href="language.exceptions.extending.html">« 扩展（extend）异常处理类</a></li>
      <li style="float: right;"><a href="language.generators.html">生成器 »</a></li>
    </ul>
  </div>
</div>
<div id="breadcrumbs" class="clearfix">
  <ul class="breadcrumbs-container">
    <li><a href="index.html">PHP Manual</a></li>
    <li><a href="langref.html">语言参考</a></li>
    <li>纤程</li>
  </ul>
</div>
<div id="layout">
  <div id="layout-content"><div id="language.fibers" class="chapter">
 <h1>纤程</h1>


 <div class="simplesect" id="language.fibers.overview">
  <h3 class="title">纤程概述</h3>
  <p class="verinfo">(PHP 8 &gt;= 8.1.0)</p>
  <p class="para">
   纤程（Fiber）表示一组有完整栈、可中断的功能。
   纤程可以在调用堆栈中的任何位置被挂起，在纤程内暂停执行，直到稍后恢复。
  </p>
  <p class="para">
   纤程可以暂停整个执行堆栈，所以该函数的直接调用者不需要改变调用这个函数的方式。
  </p>
  <p class="para">
   你可以在调用堆栈的任意地方使用 <span class="methodname"><a href="fiber.suspend.html" class="methodname">Fiber::suspend()</a></span> 
   中断执行（也就是说，<span class="methodname"><a href="fiber.suspend.html" class="methodname">Fiber::suspend()</a></span> 
   的调用位置可以在一个深度嵌套的函数中，甚至可以不存在）。
  </p>
  <p class="para">
   与无栈的 <span class="classname"><a href="class.generator.html" class="classname">Generator</a></span> 不同, 每一个
   <span class="classname"><a href="class.fiber.html" class="classname">Fiber</a></span> 拥有自己的调用栈，并允许在一个深度前度的函数调用中将它们暂停。
   声明了中断（interruption）点的函数（即调用 <span class="methodname"><a href="fiber.suspend.html" class="methodname">Fiber::suspend()</a></span>）
   不需要改变自己的返回类型，不像使用 <a href="language.generators.syntax.html#control-structures.yield" class="link">yield</a> 一样需要返回一个
   <span class="classname"><a href="class.generator.html" class="classname">Generator</a></span> 实例。
  </p>
  <p class="para">
   纤程可以在任意函数调用中被暂停，包括那些在 PHP VM 中被调用的函数。
   例如被用于 <span class="function"><a href="function.array-map.html" class="function">array_map()</a></span> 的函数或者提供
   <span class="classname"><a href="class.iterator.html" class="classname">Iterator</a></span> 实例以被 foreach 调用的方法。
  </p>
  <p class="para">
   纤程一旦被暂停，可以使用 <span class="methodname"><a href="fiber.resume.html" class="methodname">Fiber::resume()</a></span> 
   传递任意值、或者使用 <span class="methodname"><a href="fiber.throw.html" class="methodname">Fiber::throw()</a></span> 
   向纤程抛出一个异常以恢复运行。这个值或者异常将会在
   <span class="methodname"><a href="fiber.suspend.html" class="methodname">Fiber::suspend()</a></span> 中被返回（抛出）。
  </p>
  <blockquote class="note"><p><strong class="note">注意</strong>: 
   <span class="simpara">
    由于当前限制，不能在对象的析构函数中打开或关闭纤程。
   </span>
  </p></blockquote>

  <div class="example" id="language.fiber.example.basic">
   <p><strong>示例 #1 基础用法</strong></p>
   <div class="example-contents">
    <div class="phpcode"><code><span style="color: #000000">
<span style="color: #0000BB">&lt;?php<br />$fiber&nbsp;</span><span style="color: #007700">=&nbsp;new&nbsp;</span><span style="color: #0000BB">Fiber</span><span style="color: #007700">(function&nbsp;():&nbsp;</span><span style="color: #0000BB">void&nbsp;</span><span style="color: #007700">{<br />&nbsp;&nbsp;&nbsp;</span><span style="color: #0000BB">$value&nbsp;</span><span style="color: #007700">=&nbsp;</span><span style="color: #0000BB">Fiber</span><span style="color: #007700">::</span><span style="color: #0000BB">suspend</span><span style="color: #007700">(</span><span style="color: #DD0000">'fiber'</span><span style="color: #007700">);<br />&nbsp;&nbsp;&nbsp;echo&nbsp;</span><span style="color: #DD0000">"Value&nbsp;used&nbsp;to&nbsp;resume&nbsp;fiber:&nbsp;"</span><span style="color: #007700">,&nbsp;</span><span style="color: #0000BB">$value</span><span style="color: #007700">,&nbsp;</span><span style="color: #0000BB">PHP_EOL</span><span style="color: #007700">;<br />});<br /><br /></span><span style="color: #0000BB">$value&nbsp;</span><span style="color: #007700">=&nbsp;</span><span style="color: #0000BB">$fiber</span><span style="color: #007700">-&gt;</span><span style="color: #0000BB">start</span><span style="color: #007700">();<br /><br />echo&nbsp;</span><span style="color: #DD0000">"Value&nbsp;from&nbsp;fiber&nbsp;suspending:&nbsp;"</span><span style="color: #007700">,&nbsp;</span><span style="color: #0000BB">$value</span><span style="color: #007700">,&nbsp;</span><span style="color: #0000BB">PHP_EOL</span><span style="color: #007700">;<br /><br /></span><span style="color: #0000BB">$fiber</span><span style="color: #007700">-&gt;</span><span style="color: #0000BB">resume</span><span style="color: #007700">(</span><span style="color: #DD0000">'test'</span><span style="color: #007700">);<br /></span><span style="color: #0000BB">?&gt;</span>
</span>
</code></div>
   </div>

   <div class="example-contents"><p>以上例程会输出：</p></div>
   <div class="example-contents screen">
    <div class="cdata"><pre>
Value from fiber suspending: fiber
Value used to resume fiber: test
</pre></div>
   </div>
  </div>

 </div>

</div>
</div></div></body></html>